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The following font examples are printed in 12-point, with a vertical spacing of 14-point, and with non- 
alphanumeric characters separated by 4 em space. The original Special Mathematical Font was prepared 
for Bell Laboratories by Wang Laboratories, Inec., of Hudson, New Hampshire. The Times Roman, Italic, 
and Bold are among the many standard fonts available. 


Times Roman 


abedefghijklmnopqrstuvwxyz 
ABCDEFGHIJKLMNOPQRSTUVWXYZ 


1234567890 
18% &()°*4+-.,7:;=7]]| 
oO —-_ 4 4% GAA fi fh ek, Seg 


Times Italic 


abcdetghijklmnopqrstuvwxyz 
ABCDEFGHIJKLMNOPQRSTUVWXYZ 


. 1234567890 
ee ae ies Oh 
efJ/—-_4% %% sham Fees 


Times Bold 


abcdefghijklmnopqrstuvwxyz 
ABCDEFGHIJKLMNOPQRSTUVWXYZ 
1234567890 
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eO—-_%%% Aflfmm°et'eee 


Special Mathematical Font 

WV $27 eee et =* 
aBbydeln0txrApviortpastvdxX vw 
TAOAZIZTSE VQ 

Vere cae er —+<«t)x++UNCDE 
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Fig. 3.1 — Font Style Examples 
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Automatic sequence numbering of output lines may be requested with 

a ‘nm. When in effect, a 3-digit, arabic number plus a digit-space is 

3 prepended to output text lines, Text lines are offset by four digit-spaces 

and otherwise retain their line length. A reduction in line length may 

be desired to keep the right margin aligned with an earlier margin. 

5 Blank lines, other vertical spaces, and lines generated by .tl are not 

numbered. Numbering can be temporarily suspended with .nn or with a 

nm followed by a later nm +0. In addition, a line number indent J and 

9 the number-text separation S may be specified in digit-spaces. Further, 

it can be specified that only those line numbers that are multiples of 

some number M are to be printed (the others will appear as blank 

12 number fields). Table 3.8 is a summary and explanation of output line 
numbering requests. 


=P) 
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15 figure are numbered with M=%: .nm 1 3 was placed at the beginning; 

.nm was placed at the end of the first paragraph; and .nm +0 was 

placed in front of this paragraph; and .nm placed at the end. Line 

18 lengths were also changed (by \w0000'u) to keep the right side 

aligned. Another example is nm +5 5 x 3, which turns on numbering 

. with the line number of the next line to be five greater than the last 
21 numbered line, with M=5, spacing S untouched, and the indent J set to 3. 


é As an example of output line numbering, paragraph portions of this 


Fig. 3.2 — Example of Output Line Numbering 
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INPUT: 


ZES 

box; 

ece 

Leh. 

Language® Authors® Runs on 

sp 

Fortran® Many@® Almost anything 
P1/1@ IBM 360/370 

C@® BTL 11/45,H6000,370 

BLISS® Carnegie-Mellont) PDP-10,11 
IDS® Honeywell® H6000 

Pascal® Stanford® 370 


TE 
OUTPUT: 
| Language Authors = Runs on = 
Fortran Many Almost anything 
| PL/I IBM 360/370 
| C BTL 11/45,H6000,370 
| BLISS Carnegie-Mellon PDP-10,11 
IDS Honeywell H6000 
| Pascal Stanford 370 


Fig. 3.3 — Table Using “box” Option 
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INPUT: 


TS 

allbox; 

Css 

ece 

nnn. 

AT&T Common Stock 
Year® Pricet Dividend 
1971 41-54 $2.60 
2 41-54 2.70 

38@ 46-55 2.87 

AT) 40-53@ 3.24 

5D 45-52) 3.40 

6@ 51-59 .95* 


TE 
* (first quarter only) 


OUTPUT: 

: . __ AT&T Common Stock _| 
| Year | Price | Dividend 

| 1971_| 41-54 | $2.60 

| 2 | 41-54 | 2.70 

[2 So ae = EBT 

| | 4 | 40-53 | 3.24 

: e | 5 | 45-52 | 3.40 

| _6. | *51-59-°| —- ~.95* 

* (first quarter only) 

, 

' Fig. 3.4 — Table Using “allbox’’ Option 

@ 

: 

@ 
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INPUT: 


TS 
box; 
css 
ci cle 
lilin. 


ISSUE 1 


Major New York Bridges 


Bridge® Designer Length 


Brooklyn@® J. A. Roebling 1595 
Manhattan® G. Lindenthal@ 1470 
Williamsburg® L. L. BuckcD 1600 


Queensborought)Palmer &M 1182 
@ Hornbostel 


@ 1380 


Triborough® O. H. Ammann® _ 


DD 383 


Bronx Whitestone® O. H. Ammann® 2300 
Throgs Neck O. H. Ammann 1800 


.TE 
OUTPUT: 
Major New York Bridges | 
ps ge Designer —_| Length 
| Brooklyn J. A. Roebling 1595 
| Manhattan G. Lindenthal 1470 
Williamsburg —s|_ L. L. Buck — 1600 | 
Queensborough | Palmer & 1182 
a _| Hornbostel _| 
| 1380 
Triborough | O. H. Ammann 
: | See fees: Oe 
Bronx Whitestone | O. H. Ammann 2300 
Throgs Neck | O. H. Ammann 1800 
Fig. 3.5 — Table Using “Vertical bar’ Key Letter Feature 
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ete se 


eS Se ee ey ra 
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INPUT: 


dats: 

january® february® march 
april® may 

june® july® Months 

august@® september 

october® november@ december 


TE 

OUTPUT: 

january february march 

| apri may = zi 

| june july Months 
| august september 


| october november _ december 


Table Using Horizontal Lines in Place of Key Letters 
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INPUT: 


anes 

box; 

efBsss. 
Composition of Foods 


T& 

cicss 

Cites 

eheteke. 

Food® Percent by Weight 
V@_ 

\® Protein® Fat Carho- 
\V@®\'@ \'@ hydrate 


T& 

lininin. 

Apples® 4@ .5@ 13.0 
Halibut® 18.4 5.2m ... 
Lima beans(D 7.5) .8(D 22.0 
Milk® 3.3@ 4.0@ 5.0 
Mushrooms) 3.5) .4D 6.0 
Rye bread® 9.0@ .6@ 52.7 


.TE 
OUTPUT: 
Composition of Foods 
Percent by Weight 
Food ae Carbo- 
| Protein | Fat adeate 
Apples A | a 13.0 
Halibut | 184 | 62 aon 
Lima beans | 1:5 ee 22.0 
Milk eet eet 5.0 
Mushrooms | 35°} > 4 6.0 
Rye bread | 9.0 | 6 | 52.7 


Fig. 3.7 — Table Using Additional Command Lines 
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INPUT: 


TS 

allbox; 

cfl ss 

¢ cw(2i) ew(21) 


Lyi: 
& New York Area Rocks 
sp 
Era® Formation® Age (years) 
Precambrian® Reading Prong® >1 billion 
| Paleozoic® Manhattan Prong® 400 million 
Mesozoic) T{ 
na 
Newark Basin, incl. 
| é Stockton,Lockatong, and Brunswick 
| formations 
cad 
| T}@ 200 million 
Cenozoic® Coastal Plain® T{ 
na 
a On Long Island 30,000 years; 
Cretaceous sediments redeposited 
7 by recent glaciation 
| T) 
TE 


: | New York Area Rocks 

) | Kra : ___ Formation Age (years) 

? _Precambrian | Reading Prong ; | >1 billion : 

| | Paleozoic _ Manhattan Prong 2 400 million S 

| Mesozoie | Newark Basin, incl. Stockton, | 200 million 

: ; | Lockatong, and Brunswick 

! a, ___| formations _ = eee 
Cenozoic Coastal Plain - On Long Island 30,000 years; 
& Cretaceous sediments 
redeposited by recent 

. eee es = _ | glaciation f 


Fig. 3.8 — Table Using Text Blocks 
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TABLE 3.A 


CROSS REFERENCE 
REQUEST NAME TO TABLE NUMBER 


REQUEST TABLE REQUEST TABLE REQUEST TABLE REQUEST TABLE 
NAME NUMBER NAME NUMBER NAME NUMBER NAME NUMBER 
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TABLE 3.B 


ESCAPE SEQUENCES FOR 
CHARACTERS, INDICATORS, AND FUNCTIONS 


ESCAPE 
SEQUENCE 


\ (Note) \ (to prevent or delay the interpretation of \) 


A Acute accent; equivalent to \ (aa 
xe Grave accent; equivalent to \ (ga 
\- Minus sign in the current font 
\ Note) Period (dot) (see de) 


Unpaddable space-size space character 

Digit width space 

1/6 em narrow space character (zero width in the nroff formatter) 
1/12 em half-narrow space character (zero width in the nroff formatter) 
Nonprinting zero width character 

Transparent line indicator 

Beginning of comment 

Interpolate argument (1 < N > 9) 

Default optional hyphenation character 

Character named xx 

Interpolate string x or xx 

Begin conditional input 

End conditional input 

Concealed (ignored) newline character 

Noninterpreted leader character 

Bracket building function 

Interrupt text processing 

Forward (down) 1/2 em vertical motion (1/2 line in the nroff formatter) 
Printable version of current escape character 

Change to font named x or xx or position N 

Return the .af-type format of the register x or xx. Returns nothing if x 
(xx) has not yet been referenced 

Local horizontal motion; move right N (negative left) 

Mark the current horizontal output position in register x or xx 
Mark horizontal input place in register x 

Horizontal line drawing function (optionally with e) 

Vertical line drawing function (optionally with e) 

Interpolate number register x or xx 

Overstrike characters a, b, ¢, ... 

Break and spread output line 

Reverse 1 em vertical motion (reverse line in the nroff formatter) 
Point-size change function 

Noninterpreted horizontal tab 

Reverse (up) 1/2 em vertical motion (1/2 line in the nroff formatter) 
Local vertical motion; move down N (negative up) 

Interpolate width of string 


\ <space> 


\$N 
\ % 
\ (xx 

\ *x, \“(xx(Note) 


\ <newline>(Note) 
\ a(Note) 


\e 
\ fx,\f(xx,\fN 
\ gx,\g( xx 


\h’N 
\ jx,\j(xx 
\ kx 

\ Ne 


\ nx,\n(xx(Note) 


\SN,\si2N 
\ t(Note) 


\ w’string’ 


NK: Extra line-space function (negative before, positive after) 
\ ze Print e with zero width (without spacing) 
\ xX Any character not listed above 


: Ee Note: Interpreted in copy mode. 
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TABLE 3.C 


FONT CONTROL REQUESTS 


REQUEST INITIAL IF NO 
FORM VALUE ARGUMENT EXPLANATION 


Embolden font Fby N-1 units. Characters in font F'will be 
artifically emboldened by printing each one twice, sepa- 
rated by N-1 basic units. A reasonable value for Nis 3 
when the character size is in the vicinity of 10 points. If N 
is missing, the embolden mode is turned off. The mode 
must still (or again) be in effect when the characters are 
physically printed. There is no effect in the nroff formatter. 


bd SEN Embolden special font when current font is F. The charac- 
ters in the special font will be emboldened whenever the 
current font is F. The mode must still (or again) be in effect 
when the characters are physically printed. There is no 


effect in the nroff formatter. 


ignored 


Font position. A font named Fis mounted on position N(1 
through 4). It is a fatal error if Fis not known. The photo- 
typesetter has four fonts physically mounted. Each font 
consists of a film strip which can be mounted on a num- 
bered quadrant of a wheel. The default mounting sequence 
assumed by the troff formatter is R, I, B, and $ on positions 
1, 2, 3, and 4. 


previous Change to font F, where Fis x, xx, 1 through 4, or P. Font 
P means the previous font. For font changes within a line 
of text, sequences \ fx, \f(xx, or\fNcan be used. Relevant 


parameters are a part of the current environment. 


Roman 
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TABLE 3.D 


‘ 


NAMING CONVENTION FOR NON-ASCII CHARACTERS 


Non-ASCII characters and minus on the standard fonts. 


Input Character 


Char Name Name 


‘ 


Non- 


ae | 


- SPtmys Ow DAR 


close quote 


open quote 
\(em 3/4 Em dash 
= hyphen or 
\(hy hyphen 
— current font minus 
\(bu bullet 
\(sq_ square 
\(ru_— rule 
\(l4 1/4 
\(l2. 1/2 
\(34 3/4 


ASCII characters and — 


Input Character 


Name Name 

\(pl math plus 
\(mi math minus 
\(eq = math equals 
\(** math star 
\(se section 
\(aa_—sacute accent 
\(ga grave accent 
\(ul — underrule 
\(sl_ slash (matching backslash) 
\(*a_— alpha 

\(*b beta 

\(*g gamma 

\(*d delta 

\(*e epsilon 

AN ay ace 

\Cy eta 

\(*h theta 

NG nota 


Input Character 

Char Name Name 

fi. Ath = FG 

fh ACH A 

fie 

he = Nee — in 

fie NCR 

“ — \(de_— degree 

t+ \(dg dagger 

" — \(fm_— foot mark 

¢ \(ct cent sign 

® \(rg _ registered 

© \(co copyright 


Char 


ite: > RS se ae 


S$ 


wTreEGL€ Ee co xnvrarva” 


input 
Name 
\(*k 
(Si 
\(*m 
\(*n 
ie 
\(*o 
\Cp 
XG 
\(*s 
\(ts 
NC 
\(u 
\Cf 
\(*x 
\(*¥q 
\(*w 
\CTA 
YCTE 


» +» +, —, =, and * on the special font. 


Character 
Name 
kappa 
lambda 
mu 

nu 

xi 
omicron 
pi 

rho 

sigma 
terminal sigma 
lau 
upsilon 
phi 

chi 

psi 

omega 
Alphat 
Betat 


Mapped into uppercase English letters in the font mounted on font position one. 
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TABLE 3.D (Contd) 


NAMING CONVENTION FOR NON-ASCII CHARACTERS 


Input Character Input Character 
Char Name Name Char Name Name 
\@G Gamma : \(di divide 
\(D Delta \(+— plus-minus 
\CE — Epsilont \(cu cup (union) 
NO etary \(ca_ cap (intersection) 
\CtY Etat \(sb subset of 
\(*H = Theta \(sp superset of 
\CE. lotat \Gib improper subset 


\(*K  Kappat 
\(*L Lambda 


\(Gip improper superset 
\Gf infinity 


\(*M) Mut \(pd__ partial derivative 
\CN Nut \(gr gradient 

NORE Mi \(no not 

\@O  Omicront \(is integral sign 
NSE Ps \{pt proportional to 
\(*R_ Rhot \(es empty set 

\(S Sigma \(ino member of 
NC Taut \(br box vertical rule 
\(#U_ Upsilon \(dd_ double dagger 
\(*E > -Phi \(rh right hand 

\(@X = Chit \(ih left hand 

\(*Q Psi \(bs Bell System logo 


\(*W Omega 
\(sr_ square root 
\(rn root en extender 


\(or or 
\(e1= circle 
\(It left top of big curly bracket 


< See ena uvnomzzrx-OonNmen 


—— est — OO - BFGF H-—MBRBI AGBUINUNDCH + 


aN >= \(b left bottom 

So \(<s"<= \(rt right top 

= \(== identically equal \(rb night bot 

c= .\C = “approx: \(k — left center of big curly bracket 
~ \(ap approximates \(rk right center of big curly bracket 
~ \(!= not equal \(bv bold vertical 

—~ \(-—> right arrow \(F left floor (left bottom of big 
— \(<-— left arrow square bracket) 

| \(ua up arrow | \Cf right floor (right bottom) 

| \(da down arrow [f \Qe — left ceiling (left top) 

x \(mu_ multiply ] \Qe — right ceiling (right top) 


+Mapped into uppercase English letters in the font mounted on font position one. 
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TABLE 3.E 


‘CHARACTER SIZE CONTROL REQUESTS 


IF NO 
ARGUMENT EXPLANATION 


Set constant character space (width) mode on for font Fiif 
mounted). The width of every character is assumed to be 
N/36 ems. If Mis absent, the em is that of the character 
point size; if M is given, the em is M points. All affected 
characters are centered in this space including those with 
an actual width larger than this space. Special font charac- 
ters occurring while the current font is F are also so 
treated. If N is absent, the mode is turned off. The mode 
must still (or again) be in effect when the characters are 
printed. There is no effect in the nroff formatter. 


REQUEST 
FORM 


cs FNM 


Set point size to +N. Any positive size value may be re- 
quested; if invalid, the next larger valid size will result 
(maximum of 36). A paired sequence +N, —N will work 
because the previous requested value is remembered. For 
point size changes within a line of text, sequences \s.N or 
\s+N can be used. Relevant parameters are a part of the 
current environment. There is no effect in the nroff format- 
ter. 


previous 


12/36 em Set space-character size to N/36 ems. This size is the mini- 
mum word spacing in adjusted text. Relevant parameters 
are a part of the current environment. Thre is no effect in 


the nroff formatter. 


ignored 


Page 135 


DOCUMENT PROCESSING GUIDE ISSUE 1 6/82 


TABLE 3.F 


PAGE CONTROL REQUESTS 


REQUEST INITIAL 
FORM VALUE* EXPLANATION 


Begin page. The current page is ejected and a new page is 
begin. If +Nis given, the new page number will be +N. The 
page number indicator (N) is ignored if not specified in the 
request. The request causes a break. The use of “'” as the 
control character (instead of “.’) suppresses the break 
function. The request with no N is inhibited by the .ns 
request. 


Mark current vertical place in an internal register (associ- 
ated with the current diversion level) or in register R, if 
given. The request is used in conjunction with “return to 
marked vertical place in current diversion” request (.rt). 
Mode or relevant parameters are associated with current 
diversion level. 


internal 


Need N vertical spaces. The vertical space indicator (N) is 
ignored if not specified in the request. 


e If the distance to the next trap position (D) is less 
than N, a forward vertical space of size D occurs 
which will spring the trap. 


e If there are no remaining traps on the page, Dis the 
distance to the bottom of the page. 


e If Dis less than vertical spacing (V), another line 
could still be output and spring the trap. 


In a diversion, D is the distance to the diversion trap (if 
any) or is very large. Mode or relevant parameters are asso- 
ciated with current diversion level. 


Page length set to +N. The internal limitation is about 75 
inches in the troff formatter and 136 inches in the nroff 
formatter. Current page length is available in the .p regis- 
ter. The page length indicator (N) is ignored if not speci- 
fied in the request. 


Page number. The next page (when it occurs) will have the 
page number +N. The request must occur before the initial 
pseudopage transition to affect the page number of the 
first page. The current page number is in the % register. 


ignored 


ae.) 


are for the nroff and troff formatters, respectively. 


*Values separated by 
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TABLE 3.F (Contd) 


PAGE CONTROL REQUESTS 


REQUEST INITIAL IF NO 
FORM VALUE* ARGUMENT EXPLANATION 


previous Page offset. The current left margin is set to +N. The page 
ae offset indicator (N) is ignored if not specified in the re- 
quest. The troff formatter initial value provides about 1 
inch of paper margin including the physical typesetter 
margin of 1/27 inch. In the troff formatter, the maximum 
(line-length) + (page-offset) is about 7.54 inches. The cur- 
rent page offset is available in the .o register. 


internal Return (upward only) to marked vertical place in current 
diversion. If +N (with respect to place) is given, the verti- 
cal place is +Nfrom the top of the page or diversion. If Nis 
absent, the vertical place is marked by a previous .mk. The 
.sp request may be used in all cases instead of .rt by spacing 
to the absolute place stored in an explicit register; e.g., 
using the sequence .mk R ... .sp/\nRu. Mode or relevant 
parameters are associated with current diversion level. 


66,77 


*Values separated by are for the nroff and troff formatters, respectively. 
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TABLE 3.G 


TEXT FILLING, ADJUSTING, AND CENTERING REQUESTS 


REQUEST INITIAL IF NO 
FORM VALUE ARGUMENT EXPLANATION 


Adjust. Output lines are adjusted with mode N. If the type 
indicator (N) is present, the adjustment type is as follows: 


ADJUSTMENT TYPE 
] adjust left margin only 
i adjust right margin only 
c center 
born adjust both margins 
absent unchanged 


The adjustment type indicator N may also be a number 
obtained from the .j register. If fill mode is not on, adjust- 
ment will be deferred. Relevant parameters are a part of 
the current environment. 


Break. Filling of the line currently being collected is 
stopped, and the line is output without adjustment. Text 
lines beginning with space characters and empty text lines 
(blank lines) also cause a break. 


Center. The next N input text lines are centered within the 
current line-length, If N=0, any residual count is cleared. 
A break occurs after each of the N input lines. If the input 
line is too long, it will be left adjusted. The request nor- 
mally causes a break. Relevant parameters are a part of 
the current environment. 


Fill mode. The request causes a break. Subsequent output 
lines are filled to provide an even right margin. Relevant 
parameters are a part of the current environment. 


No adjust. No output line adjusting is done. Since adjust- 
ment is turned off, the right magin will be ragged. Adjust- 
ment type for the .ad request is not changed. Output line 
filling still occurs if fill mode is on. Relevant parameters 
are a part of the current environment. 


No-fill mode. Subsequent output lines are neither filled nor 
adjusted. The request normally causes a break. Input text 
lines are copied directly to output lines without regard for 
the current line length. Relevant parameters are a part of 
the current environment. 
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TABLE 3.H 


VERTICAL SPACING REQUESTS 


REQUEST IF NO 
FORM ARGUMENT EXPLANATION 


previous Line spacing set to +N. Output N-1 blank lines (Vs) after 
each output text line. If the text or previous tate 
blank line reached a trap position, appended blank lines are 
omitted. Relevant parameters are a part of the current 
environment. 


Set no-space mode on. The no-space mode inhibits .sp and 
-bp requests without a next page number. It is turned off 
when a line of output occurs or with the .rs request. Mode or 
relevant parameters are associated with current diversion 
level. 


Output saved vertical space. The request is used to output a 
block of vertical space requested by an earlier .sv request. 
The no-space mode has no effect. 


Restore spacing. The no-space mode is turned off. Mode or 
relevant parameters are associated with current diversion 
level. 


Space vertically. The request provides spaces in either di- 
rection. If Nis negative, the motion is backward (upward) 
and is limited to the distance to the top of the page. For- 
ward (downward) motion is truncated to the distance to the 
nearest trap. The space indicator (N) is ignored if not spec- 
ified in the request. If the no-space mode is on, no spacing 
occurs (see .ns and .rs). The request causes a break. 


Save a contiguous vertical block of size N. If the distance to 
the next trap is greater than N, N vertical spaces are out- 
put. If the distance to the next trap is less than N, no 
vertical space is immediately output; but Nis remembered 
for later output (see .os). Subsequent .sv requests overwrite 
any still remembered N. No-space mode has no effect. The 
vertical block size indicator (N) is ignored if not specified. 


previous Set vertical base-line spacing size V. Transient extra verti- 
cal spaces are available with\x’N. The vertical base-line 
spacing indicator (N) is ignored if not specified in the re- 
quest. Relevant parameters are a part of the current envi- 
ronment. 


Blank line This condition causes a break and output of a blank line 


(just as does .sp D. 


44,97 


*Values separated by 


are for the nroff and troff formatters, respectively. 
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TABLE 3.1 


LINE LENGTH AND INDENTING REQUESTS 


REQUEST INITIAL IF NO 
FORM VALUE ARGUMENT EXPLANATION 


previous 


Indent. The indent is set to +N and prepended to each 
output line. Indent indicator (N) is ignored if not specified 
by the request. Relevant parameters are a part of the cur- 
rent environment. The request causes a break. 


previous Line length. The line length is set to +N. In the troff for- 
matter, the maximum (line-length) + (page-offset) is about 
7.54 inches. The line length indicator (N) is ignored if not 
specified in the request. Relevant parameters are a part of 


the current environment. 


ignored Temporary indent. The next output text line will be in- 
dented a distance +N with respect to the current indent. 
The resulting total indent may not be negative. The current 
indent is not changed. The indent indicator (N) is ignored 
if not specified in the request. Relevant parameters are a 
part of the current environment. The request causes a 
break. 
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TABLE 3.J 


MACROS, STRINGS, DIVERSIONS, AND POSITION TRAPS REQUESTS 


REQUEST INITIAL 
FORM VALUE EXPLANATION 


am Xx yy Append to macro xx (append version of .de). 


.as xx string ignored Append string to string xx (append version of .ds). 


Chey Change trap location. Change the trap position for macro 
xx to be N. In the absence of N, the trap, if any, is re- 
moved. The trap location indicator (N) is ignored if not 


specified in the request. 


Divert and append to macro xx (append version of the .di 
request). Mode or relevant parameters are associated with 
current diversion level. 


Define or redefine macro xx. The contents of the macro 
begin on the next input line. Input lines are copied in copy 
mode until the definition is terminated by a line beginning 
with .yy. The macro yyis then called. In the absence of yy, 
the definition is terminated by a line beginning with “..”. A 
macro may contain .de requests provided the terminating 
macros differ or the contained definition terminator is con- 
cealed; “..” can be concealed as “\\.” which will copy as 
Ne * ead be reread as “..” 


Divert output to macro xx. Normal text processing occurs 
during diversion except that page offsetting is not done. 
The diversion ends when the request .di or .da is encoun- 
tered without an argument; extraneous requests of this 
type should not appear when nested diversions are being 
used. Mode or relevant parameters are associated with cur- 
rent diversion level. 


ds xx string 


ignored Define a string xx containing string. Any initial double- 


quote in string is stripped to permit initial blanks. 


dt N xx 


off Install a diversion trap at position Nin the current diver- 
sion to invoke macro xx. Another .dt will redefine the div- 
ersion trap. If no arguments are given, the diversion trap is 
removed. Mode or relevant parameters are associated with 


current diversion level. 


End macro. Macro xx will be invoked when all input has 
ended. The effect is the same as if the contents of xx had 
been at the end of the last file processed. 
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TABLE 3.) (Contd) 


MACROS, STRINGS, DIVERSIONS, AND POSITION TRAPS REQUESTS 


REQUEST INITIAL 
FORM VALUE EXPLANATION 


Input-line-count trap. An input-line-count trap is set to 
invoke the macro xx after N lines of text input have been 
read (control or request lines do not count). Text may be in- 
line or interpolated by in-line or trap-invoked macros. Rel- 
evant parameters are a part of the current environment. 


ignored Remove. A request, macro, or string is removed. The name 
xx is removed from the name list and any related storage 


space is freed. Subsequent references have no effect. 


mm xx yy ignored Rename. Rename request, macro, or string from xx to yy. 


If yy exists, it is first removed. 


wh N xx 


When. A location trap is set to invoke xx at page position 
N; a negative N is interpreted with respect to the page 
bottom. Any macro previously planted at Nis replaced by 
xx. A zero N refers to the top of a page. In the absence of 
xx, the first found trap at N, if any, is removed. The page 
position indicator (N) is ignored if not specified in the re- 
quest. 
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TABLE 3.K 


PREDEFINED GENERAL NUMBER REGISTERS 


REGISTER 
NAME DESCRIPTION 


Current page number. 

Character type (set by width function), 
Width (maximum) of last completed diversion. 

Height (vertical size) of last completed diversion. 

Current day of the week (1 through 7). 

Current day of the month (1 through 31). 

Current horizontal place on input line. 

Output line number. 

Current month (1 through 12). 

Vertical position of last printed text base line. 

Depth of string below base line (generated by width function). 

Height of string above base line (generated by width function). 

Last two digits of current year. 

Provides general register access to the input line number in the current input file. 
Contains the same value as the read-only .c register. 

Number of number registers that remain available for use. 

Emboldening factor of the current font. 
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TABLE 3.L 


PREDEFINED READ-ONLY NUMBER REGISTERS 


REGISTER 
NAME DESCRIPTION 


Number of arguments available at the current macro level. 

Set to 1 in the troff formatter if —a option used; always 1 in the nroff 
formatter. 

Value is a string that is the name of the current input file. 
Available horizontal resolution in basic units. 

Contains the current line spacing parameter (the value of the most 
recent .ls request). 

Contains the value 1 if the current page is being printed and the 
value 0 if the current page is not in the —o option list. 

Set to 1 in the nroff formatter if —T option used; always 0 in the troff 
formatter. 

Available vertical resolution in basic units. 

Post-line extra line space most recently utilized using x’N. 
Number of lines read from current input file. 

Current vertical place in current diverson; equal to nl if no diversion. 
Current font as physical quadrant (1 through 4). 

Text base-line high-water mark on current page or diversion. 
Current ident. 

Indicates the current adjustment mode and type. Can be saved and 
later given to the .ad request to restore a previous mode. 

“ontains the horizontal size of the text portion (without ident) of the 
current partially collected output line, if any, in the current environ- 
ment. 

Current line length. 

Length of text portion on previous output line. 

Current page offset. 

Current page length. 

Current point size. 

Distance to the next trap. 

Equal to 1 in fill mode and 0 in no-fill mode. 

Current vertical line spacing. 

Width of previous character. 

Reserved version-dependent register. 

Reserved version-dependent register. 

Name of current diversion. 


Siti b ine & x 


= 


pek Se cer b vob 
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TABLE 3.M 


& ’ NUMBER REGISTERS REQUESTS 


REQUEST INITIAL IF NO 
FORM VALUE ARGUMENT EXPLANATION 


arabic Assign format. Format cis assigned to register R. Avail- 
able formats are: 
c NUMBERING SEQUENCE 
1 Oc 2a 5o 
001 000,001,002,003,004,0085.,... 
i 0,i,ii,iii,iv,v,... 
I 0,L,U,1IL,IV,YV.... 
a 0,a,b,...,2,48,aD,...,2Z,22,... 
A 0,A,B,,...,2,NA,AB,...,ZZ,AAA,... 
An arabic format having N digits specifies a field width of 
N digits. Read-only registers and width function are al- 
ways arabic. 
Number register. The number register Ris assigned the 
value +.N with respect to the previous value, if any. The 
automatic incrementing value is set to M. The number 
register value (N) is ignored if not specified in the request. 
— Remove register. The number register R is removed. If 
many registers are being created dynamically, it may be 
necessary to remove registers that are no longer used in 
order to recapture internal storage space for newer regis- 
ters. 
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TABLE 3.N 


TABS, LEADERS, AND FIELDS REQUESTS 


INITIAL IF NO 
VALUE* ARGUMENT EXPLANATION 
off off 


Field delimiter is set to a. The padding indicator is set to 
the space character or to b, if given. In the absence of 
arguments, the field mechanism is turned off. 


REQUEST 
FORM 


Leader repetition character becomes ¢ or is removed spec- 
ifying motion. Relevant parameters are a part of the cur- 
rent environment. 


Set tab stops and types. 
When the tab type indicator (t) is: 

R — text is right adjusted 

C — text is centered 
Absent — text is left adjusted. 
Tab stops for the troff formatter are preset every 0.5 inch; 
tab stops for the nroff formatter are preset every eight 
nominal character widths. Stop values are separated by 
spaces, and a value preceded by + is treated as an incre- 
ment to the previous stop value. Relevant parameters are 
a part of current environment. 


Tab repetition character becomes cor is removed specify- 
ing motion. Relevant parameters are a part of the current 
environment. 


coy? 


*Values separated by “;” are for the nroff and troff formatters, respectively. 
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TABLE 3.0 


INPUT AND OUTPUT CONVENTIONS AND CHARACTER TRANSLATIONS REQUESTS 


EXPLANATION 


Set control character to cor reset to “.”. Relevant parame- 
ters are a part of the current environment. 


Continuous underline in the nroff formatter. A variant of 
.ul that causes every character to be underlined. Identical 
to .ul in the troff formatter. Relevant parameters are a 
part of the current environment. 


& : Set no-break control character to ¢ or reset to “’”. Rele- 
vant parameters are a part of the current environment. 


Set escape character to \ or to e, if given. 
Turn escape character mechanism off. 


Ligature mode is turned on if Nis absent or nonzero and 
turned off if N=0. If N=2, only the 2-character ligatures 
are automatically invoked. Ligature mode is inhibited for 
request, macro, string, register, file names, and copy 
mode. There is no effect in the nroff formatter. 


& 2 Translate a into b, c into d, ete. on output. If an odd 
number of characters is given, the last one will be mapped 
into the space character. To be consistent, a particular 
translation must stay in effect from input to output time. 
Initially, there are no translate values. 


Italic Italic Underline font set to F (to be switched to by .vl). In the 
nroff formatter, F may not be on position 1 (initially Times 
Roman). 


Underline in the nroff formatter (italicize in troff the next 
N input text lines). Switch to underline font saving the 
current font for later restoration; other font changes 

ee within the span of a .ul will take effect, but the restoration 
will undo the last change. Output generated by a .tl is 
affected by the font change but does not decrement N. If 
N is greater than 1, there is the risk that a trap interpo- 
lated macro may provide text lines within the span, which 
environment switching can prevent. Relevant parameters 
are a part of the current environment. 
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& *Values separated by “;” are for the nroff and troff formatters, respectively. 
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TABLE 3.P 
LOCAL MOTIONS 


VERTICAL LOCAL MOTION 


\vN Move distance N 
1/2 em up 

1/2 em down 

1 em up 


1/2 line up 
1/2 line down 
1 line up 


HORIZONTAL LOCAL MOTION 


EFFECT IN 


\h’N Move distance N 
\(space) | Unpaddable space-size space 


Digit-size space 
ignored 
ignored 


1/6 em space 
1/12 em space 
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TABLE 3.Q 


HYPHENATION REQUESTS 


REQUEST INITIAL IF NO 
FORM VALUE ARGUMENT EXPLANATION 


\% Hyphenation character. Hyphenation indicator character 

is set to e or to the default \%. The indicator does not 
appear in the output. Relevant parameters are a part of 
the current environment. 


-hw word 1... ignored Exception words. Hyphenation points in words are speci- 
fied with imbedded minus signs. Versions of a word that 
end with an s are implied; i.e., dig-it implies dig-its. This 
list is examined initially and after each suffix stripping. 


Space available is small—about 128 characters. 


Hyphenate. Automatic hyphenation is turned on for N 
greater than or equal to 1 or off for N=0. If N=2, last lines 
(ones that will cause a trap) are not hyphenated. For N=4 
and N=8, the last and first two characters, respectively, of 
a word are not divided. These values are additive; i.e., 
N=14 invokes all three restrictions. Relevant parameters 
are a part of the current environment. 


no hyphen No hyphenation. Automatic hyphenation is turned off. 
Relevant parameters are a part of the current environ- 


ment. 
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TABLE 3.R 


THREE-PART TITLES REQUEST 


REQUEST INITIAL IF NO 
FORM VALUE ARGUMENT EXPLANATION 


previous | Length of title set to +N. Line length and title length are 
independent. Indents do not apply to titles; page offsets 
do. Relevant parameters are a part of the current environ- 
ment. 


pe c Page number character set to e or removed. The page 
number register remains %. 


tl ‘left’center’right’ Three-part title. The strings left, center, and right are, 
respectively, left adjusted, centered, and right adjusted in 
the current title length. Any of the strings may be empty, 
and overlapping is permitted. If the page number charac- 
ter (initially %) is found within any of the fields, it is 
replaced by the current page number having the format 
assigned to register %. Any character may be used as the 
string delimiter. 
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TABLE 3.5 


‘OUTPUT LINE NUMBERING REQUESTS 


REQUEST INITIAL IF NO 
FORM VALUE ARGUMENT EXPLANATION 


omm+tNMSI off 
on N N=1 


Line number mode. If +N is given, line numbering is 
turned on; and the next output line is numbered +N. De- 
fault values are M=1, S=1, and 0. Parameters corre- 
sponding to missing arguments are unaffected; a nonnu- 
meric argument is considered missing. In the absence of 
all arguments, numbering is turned off, and the next line 
number is preserved for possible further use in number 
register In. Relevant parameters are a part of the current 
environment. 


Next Nlines are not numbered. Relevant parameters are a 
part of the current environment. 
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TABLE 3.T 


CONDITIONAL ACCEPTANCE OF INPUT REQUESTS 


REQUEST INITIAL IF NO 
FORM VALUE ARGUMENT EXPLANATION 


el anything The “else” portion of “if-else”. 


je c anything The “if” portion of “if-else”. The ecan be any of the forms 
acceptable with the .if request. 


if ¢ anything If condition e true, accept anything as input; for multi- 
line case, use \{anything\}. 


if !e anything If condition e false, accept anything. 


if N anything If expression N greater than 0, accept anything. 
Jif !N anything If expression N less than or equal to 0, accept anything. 


if ‘string]’ string2’ anything If string 1 is identical to string 2, accept anything. 


if string 1’ string2’ anything If string 1 is not identical to string 2, accept anything. 


TABLE 3.U 


ENVIRONMENT SWITCHING REQUEST 


REQUEST INITIAL IF NO 
FORM VALUE ARGUMENT EXPLANATION 


ev N previous Environment switched to 0, 1, or 2. Switching is done in 
pushdown fashion so that restoring a previous environ- 
ment must be done with .ev rather than specific reference. 
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TABLE 3.V 
INSERTIONS FROM STANDARD INPUT REQUESTS 


REQUEST INITIAL IF NO 
FORM VALUE ARGUMENT EXPLANATION 


Exit from the nroff/troff formatter. Text processing is ter- 
minated exactly as if all input had ended. 


rd prompt prompt=BEL 


Read insertion from the standard input until two newline 
characters in a row are found. If standard input is the user 
keyboard, a prompt (or a BEL) is written onto the user 
terminal. The request behaves like a macro; arguments 
may be placed after prompt. 


TABLE 3.W 


INPUT/OUTPUT FILE SWITCHING REQUESTS 


nx filename end-of-file Next file is filename. The current file is considered ended, and 
the input is immediately switched to file- 
name. 


.pi program Pipe output to program (nroff formatter only). This request must 


occur before any printing occurs. No arguments are transmitted to 
program. 


so filename 
Switch source file (pushdown). The top input level (file reading) is 
switched to filename. Contents are intepolated at the point the 
request is encountered. When the new file ends, input is again 
taken from the original file. The .so requests may be nested. 
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TABLE 3.X 


MISCELLANEOUS REQUESTS 


REQUEST INITIAL IF NO 
FORM VALUE ARGUMENT EXPLANATION 


Specify the point in the macro file at which compaction 
ends. When —kname is called on the command line, all 
lines in the file name before the .co request will be com- 
pacted. 


Flush output buffer. Used in interactive debugging to 
force output. The request causes a break. 


Ignore input lines until call of yy. This request behaves 
like the .de request except that the input is discarded. The 
input is read in copy mode, and any automatically incre- 
mented registers will be affected. 


Sets margin character e¢ and separation N. Specifies that 
a margin character e appear a distance N to the right of 
the right margin after each nonempty text line (except 
those produced by .tl). If the output line is too long (as can 
happen in no-fill mode), the character will be appended to 
the line. If N is not given, the previous N is used; the 
initial N is 0.2 inches in the nroff formatter and 1 em in 
troff. Relevant parameters are a part of the current envi- 
ronment. 


‘mc ec N 


Print macros. The names and sizes of all defined macros 
and strings are printed on the user terminal. If tis given, 
only the total of the sizes is printed. Sizes are given in 
blocks of 128 characters. 


Print string on terminal (UNIX operating system stan- 
dard message output). After skipping initial blanks, string 
(rest of the line) is read in copy mode and written on the 
user terminal. 


newline 


.tm string 


TABLE 3.Y 


OUTPUT AND ERROR MESSAGES REQUEST 


REQUEST INITIAL IF NO 
FORM VALUE ARGUMENT EXPLANATION 


ab text Prints text on the message output and terminates with- 
out further processing. If textis missing, “User Abort.” is 
printed. This request does not cause a break. The output 
buffer is flushed. 
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TABLE 3.Z 


NAMING CONVENTION FOR THE 
MATHEMATICS TYPESETTING PROGRAM 


| CHARACTER | INPUT 
SEQUENCE OUTPUT | NAME CHARACTER 
>= = | DELTA A 
<= = | GAMMA ‘é 
== = | LAMBDA A 
l= 7 | OMEGA Q) 
eae ee PHI & 
f'> > PI Il 
ee" _ PSI v 
| << << | SIGMA z | 
Bess = | THETA S) 
| inf a0 | | UPSILON T 
| partial f) | XI a 
| half Vy | alpha a 
prime : beta B 
approx = | chi x 
nothing | delta 5 
cdot ’ | epsilon € 
times x | eta n 
del V | gamma + 
grad V | | iota n 
eee | kappa x 
Paes Ape | lambda r 
| sum ys mu mM 
- int i au e: 
| prod Il omega w 
_ union L) omicron 0 
| inter ‘e phi 
pi tg 
| psi Wy 
rho p 
sigma o 
tau T 
| theta 6 
| upsilon v 
| xi E 
oe Reaper aes ie zeta ny ¢ 
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